home *** CD-ROM | disk | FTP | other *** search
/ Merciful 2 / Merciful - Disc 2.iso / software / v / varkcliutils11.dms / varkcliutils11.adf / VARK / Arud.doc / Arud.doc
Text File  |  1996-02-15  |  5KB  |  222 lines
  1.  
  2.  ARUD CONVERTER V2.2
  3.  
  4.  CREDITS
  5.     - Coding : Morten Amundsen
  6.     - Idea   : Jan Erik Arud
  7.  
  8.  NOTE
  9.     Arud Converter v2.2 requires AmigaOS V39+ and reqtools.library.
  10.  
  11.  
  12.  ADDRESS
  13.     Morten Amundsen
  14.     Rute 20/14, Hjukebø
  15.     3670 NOTODDEN
  16.     NORWAY
  17.  
  18.     TEL: 35 95 74 57
  19.  
  20.  HISTORY
  21.     In the fall of 1993, Jan Erik Arud of Notodden, Norway, asked
  22.     me to make a program for him that could rename files.
  23.     All of the files had the same "basename", and all of them had
  24.     a number attached to it. He needed this program for renaming
  25.     animations, and since there was a lot of files, doing this
  26.     manually was a time consuming task.
  27.     The first version was finished merly days after he asked me,
  28.     but he was not completly satisfied with it, so I scraped it
  29.     and did some adjustments.
  30.  
  31.     After releasing a few versions in 1993, I decided to make
  32.     an update now (Oct. 1995). This time font-sensitive and
  33.     a more fool-proof program.
  34.     It is now also possible to force the program to look for
  35.     files with a user pre-defined basename.
  36.  
  37.     As of version 2.2, the user can specify if the files are to
  38.     be renamed, copied or copied to a specified directory.    
  39.  
  40.  USAGE
  41.     First of all select a path by clicking the "Path"
  42.     gadget, or typing it in manually.
  43.  
  44.     Let's say we have a drawer called "Animation". There are 10
  45.     files in this drawer called:
  46.  
  47.     NOTE! If you have a drawer with lots of files with different
  48.           basenames, it it possible to pre-define the basename in
  49.           the "Base" gadget, and then set the "First/Force" gadget to
  50.           Force. If you select a path now, the program will only
  51.           look for files with this basename.
  52.  
  53.     Anim1
  54.     Anim10
  55.     Anim2
  56.     Anim3
  57.     Anim4
  58.     Anim5
  59.     Anim6
  60.     Anim7
  61.     Anim8
  62.     Anim9
  63.  
  64.     After selecting the path the result could look like this:
  65.  
  66.     Basename:        Anim
  67.     Places needed:        2
  68.     Files:            10
  69.     Range:            1-10
  70.  
  71.     - Basename
  72.         This is the "name" part of the file, which is
  73.         similar for all the files. (Anim)
  74.  
  75.     - Places needed
  76.         This is how many places the biggest number requires.
  77.         In our example it is 2, because 10 needs 2 places.
  78.         If there were 1000 files it would require 4 places.
  79.         As of V2.2, the field now also shows the max number
  80.         of places used in the current number sequence.
  81.  
  82.     - Files
  83.         Number of files in the directory. (10)
  84.  
  85.     - Range
  86.         Smallest filenumber upto biggest filenumber
  87.  
  88.  GADGETS
  89.     
  90.     - Base
  91.         This gadget let's you change the filename base of the
  92.         files in the selected drawer.
  93.         Example: "Arud"
  94.  
  95.     - First/Force
  96.         In the "First" position, the program will use the first
  97.         files of the right composition it can find in the chosen
  98.         directory.
  99.         In the "Force" position, it will only look for files with
  100.         the chosen basename.
  101.         PS! The program will refuse to go into "Force-mode" if
  102.             the Basename is empty.
  103.  
  104.     - Places
  105.         Tells the program how many places (of numbers) to
  106.         use in the numbers field.
  107.         This number must be able to fill: StartValue+NoOfFiles
  108.         Example: "5"
  109.  
  110.     - Start Value
  111.         Any positive integer of which the numbers should start
  112.         renaming from.
  113.         Example: "500"
  114.  
  115.     - No Leading Zeros/Leading Zeros
  116.         This cycle gadget lets you select if you want to
  117.         remove unfilled places if "Places" is bigger
  118.         than the required number of places needed to fill
  119.         "Start Value" + "Files".
  120.  
  121.     - Same Order/Reverse Order
  122.         By using this gadget you are able to reverse the order
  123.         of renaming, so that the lowest numbered file now becomes
  124.         the highest. (...and the highest, the lowest.)
  125.  
  126.     - Rename/Copy/Copy To
  127.         This gadget gives the user the option of either renaming
  128.         all the files or copy the files to their new names,
  129.         leaving the old files be with their original names.
  130.         In the "Copy To" position a file requester will pop
  131.         up, so that you can choose a destination directory.
  132.  
  133.     - Convert
  134.         Start the renaming process (error checking is done here).
  135.  
  136.     - Quit
  137.         Exit the program.
  138.  
  139.  
  140.  EXAMPLE
  141.     If we use the numbers given in the examples in the GADGETS section
  142.     it would turn out like this:
  143.  
  144.     - Leading Zeros ON
  145.  
  146.         Arud00500
  147.         Arud00501
  148.         Arud00502
  149.         Arud00503
  150.         Arud00504
  151.         Arud00505
  152.         Arud00506
  153.         Arud00507
  154.         Arud00508
  155.         Arud00509
  156.  
  157.     - Leading OFF
  158.  
  159.         Arud500
  160.         Arud501
  161.         Arud502
  162.         Arud503
  163.         Arud504
  164.         Arud505
  165.         Arud506
  166.         Arud507
  167.         Arud508
  168.         Arud509
  169.  
  170.     If the Rename/Copy gadget has been set to "Copy", there would
  171.     be two set of files.
  172.  
  173.     - Leading ON
  174.  
  175.         Anim1
  176.         Anim10
  177.         Anim2
  178.         Anim3
  179.         Anim4
  180.         Anim5
  181.         Anim6
  182.         Anim7
  183.         Anim8
  184.         Anim9
  185.         Arud00500
  186.         Arud00501
  187.         Arud00502
  188.         Arud00503
  189.         Arud00504
  190.         Arud00505
  191.         Arud00506
  192.         Arud00507
  193.         Arud00508
  194.         Arud00509
  195.  
  196.     - Leading OFF
  197.  
  198.         Anim1
  199.         Anim10
  200.         Anim2
  201.         Anim3
  202.         Anim4
  203.         Anim5
  204.         Anim6
  205.         Anim7
  206.         Anim8
  207.         Anim9
  208.         Arud500
  209.         Arud501
  210.         Arud502
  211.         Arud503
  212.         Arud504
  213.         Arud505
  214.         Arud506
  215.         Arud507
  216.         Arud508
  217.         Arud509
  218.  
  219.  COPYRIGHTS
  220.     - Arud Converter V2.2 is a postcard-ware program
  221.     - reqtools.library is copyright (C) Nico François
  222.